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Use of DANGER, WARNING, CAUTION, and NOTE 


This publication includes, DANGER, WARNING, CAUTION, and NOTE information where appropriate to point out 
safety related or other important information. 


DANGER Hazards which could result in severe personal injury or death 
WARNING Hazards which could result in personal injury 

CAUTION Hazards which could result in equipment or property damage 
NOTE Alerts user to pertinent facts and conditions 


Although DANGER and WARNING hazards are related to personal injury, and CAUTION hazards are associated with 
equipment or property damage, it should be understood that operation of damaged equipment could, under certain 


operational conditions, result in degraded process performance leading to personal injury or death. Therefore, comply fully 
with all DANGER, WARNING, and CAUTION notices. 


TRADEMARKS 


Advant, AdvaBatch, AdvaCommand, AdvaInform, AdvaBuild, and AdvaTalk are registered trademarks of ABB Asea 
Brown Boveri Ltd, Switzerland. 


Microsoft and Windows NT are registered trademarks of Microsoft Corporation. 


NOTICE 


The information in this document is subject to change without notice and should not be construed as a commitment by 
ABB Automation AB. ABB Automation AB. assumes no responsibility for any errors that may appear in this document. 


In no event shall ABB Automation AB. be liable for direct, indirect, special, incidental or consequential damages of any 
nature or kind arising from the use of this document, nor shall ABB Automation AB. be liable for incidental or 
consequential damages arising from use of any software or hardware described in this document. 


This document and parts thereof must not be reproduced or copied without ABB Automation AB.’s written permission, 
and the contents thereof must not be imparted to a third party nor be used for any unauthorized purpose. 


The software described in this document is furnished under a license and may be used, copied, or disclosed only in 
accordance with the terms of such license. 


Copyright © ABB Automation AB. 2000 
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Chapter 1 Introduction 


Introduction covers the following topics: About this Book, Product Overview, 
Prerequisites and Requirements, Related Documentation, Conventions, 
Terminology. 


1.1 About this Book 


This book describes Advant® Reports Add-Ins version 1.0. This software package 
lets you use Microsoft® Excel to access Advant Open Control System (OCS) 
objects for ad-hoc queries and re-executable reports. 


This book is not the sole source of instruction for Advant Reports Add-Ins. It is 
recommended that those people who use this product attend the applicable training 
courses offered by ABB. 


The following are some quick guidelines to help you find what you are looking for 
in this book. 


Where to Start 


If you are a first-time user, refer to Section 1.2.1, What You Can Do with Advant 
Reports Add-Ins. 


Installing Advant Reports Add-Ins Software 


Advant Reports Add-Ins software is installed as part of the Advant Workplace 
software package. This is described in the Advant Workplace Products 
Administrator’s Guide. 


After installing Advant Reports Add-Ins software, these add-ins must be added to 
Microsoft Excel. How to do this is described in Chapter 2, Installation. 


Configuring Advant Reports Add-Ins Software 


Advant Reports Add-Ins is ready to use after you install the software on your PC, 
and add the ad-ins to Microsoft Excel; however, you may want to customize the 
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user interface to suit your specific application. Refer to Chapter 3, Configuration for 
instructions on how to configure (customize) the user interface. 


Using Advant Reports Add-Ins within an Excel Spreadsheet 


Refer to Chapter 4, Operation to learn how to set up and execute queries using 
Advant Reports Add-Ins in an Excel Spreadsheet. 


Administrative Procedures 


Administrative procedures for Advant Reports Add-Ins and other Advant 
Workplace applications are described in the Advant Workplace Products 
Administrator’s Guide. 


1.2 Product Overview 


Advant Reports Add-Ins runs as an add-in program for Microsoft Excel 97 on a 
Windows NT or Windows 95 workstation. 


First-time users should read Section 1.2.1, What You Can Do with Advant Reports 
Add-Ins for a quick overview. The complete product release history is described in 
Section 1.2.2, Product Release History. 


1.2.1 What You Can Do with Advant Reports Add-Ins 


Advant Reports Add-Ins lets you use Microsoft Excel to access information from 
Advant OCS applications. Advant Reports Add-Ins provides: 


e Dialogs for Ad-hoc Data Retrieval 
¢ Function Calls for Building Reports in Microsoft Excel 


Using either of these methods, you can make the following types of data requests 
from an Excel spreadsheet: 


° Process values 
e — Historical log data 


e¢  Alarm/Event messages 
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Advant Reports Add-Ins lets you work with industry-standard tools using familiar 
techniques common to Microsoft Office products. 


1.2.1.1 Dialogs for Ad-hoc Data Retrieval 


Advant Reports Add-Ins provides interactive dialogs that let you generate ad-hoc 
queries for Advant OCS information. To learn more about these dialogs see: 


¢ Section 4.2.1, Retrieving the Current Value for a Single Process Object 
¢ Section 4.2.2, Retrieving the Current Value for Multiple Process Objects 
¢ Section 4.2.3, Retrieving History Values for a Single History Log 

e¢ Section 4.2.4, Retrieving Values for Multiple History Logs 

e¢ Section 4.2.5, Retrieving Alarm and Event Data 


Some of these dialogs support data formatting and orientation options. For details 
see Section 3.3, Setting Data Format and Communication/File Setup Options. 


1.2.1.2 Function Calls for Building Reports in Microsoft Excel 


The Advant Reports Add-Ins functions let you build, execute, and save reports via 
Microsoft Excel worksheets, Figure 1-1. The functions provide the same data 
retrieval capabilities as the dialogs, except that the functions can be re-executed by 
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running the spreadsheet. The results can be saved, archived, printed and rerun. See 
Section 4.3, Building and Running Reports for details. 


[DSH SAY 2BAT O-9 BOS EAN GSB |m 
[far Si ea lS %, 8 8| | D- o-A-| 
=ABBGetoBJ(S6 16 "LOOPDESC") 


(Press F9 to update or Ctrl - ato start Macro, to stop macro press Ctrl-Break) 


Name Loop Description Set Point Me 
CCF_PID_LO! AC3010 Ac3010 [OVERHD COMP DISTILLATION] 95 95) 


CCF_PID_LO! AC3023 AC3023 BOTTOM COMP DISTILLATION 5 50 
[IN Sheett ¢ Sheet? f Sheet / eee ol 


Figure 1-1. Example, Advant Reports Add-Ins Function in an Excel Spreadsheet 


Associating Reports with Plant Objects 


You can associate the report with a plant object, for instance, a plant area, unit, or 
tag object. This is done by using the Advant Plant Explorer to create a report aspect 
for the object. This aspect lets you access the report via the Plant Explorer. Opening 
the aspect launches Excel with the specified report. 


Details regarding management of objects and aspects are provided in the Advant 
Plant Explorer User’s Guide. Specific guidelines for report-type aspects are 
provided in Section 4.3.3, Associating Reports with Plant Objects. 


1.2.2 Product Release History 


Table 1-1 lists the major milestones in the development of Advant Reports Add-Ins. 


Table 1-1. Release History 


Version Description 


1.0 This is the initial release of Advant Reports Add-Ins 
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On-line Help 


Access to the complete help files is available via the Help menu in the main menu 
bar. Context-sensitive help (F1) is available for some windows, dialogs, and fields. 


1.3 Prerequisites and Requirements 


General hardware and software requirements for Advant Workplace applications are 
described in the Advant Workplace Products Administrator’s Guide. 


The following are PC requirements specifically for Advant Reports Add-Ins: 
¢ Memory: 


— Windows NT 4.0 w/Service Pack 3 requires 48 MB minimum (64 MB 
recommended) 


¢ 10 MB of disk space 
¢ Microsoft Office 97 or Excel97 with Service Release 1 (SR-1) 
e Visual Basic for Applications installed (VBA) 


° 133MHz Pentium recommended (minimum) 


1.4 Related Documentation 


Table 1-2 lists all documentation related to Advant Reports Add-Ins. 


Table 1-2. Related Documentation 


Category Title Description 
System Advant Workplace Products This book describes how you install the 
Administration | Administrator’s Guide Advant Workplace Products software, 


including software options, and how you 
then perform maintenance. 
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Table 1-2. Related Documentation (Continued) 


Category Title Description 
Software Advant Workplace This book describes everything about 
User’s Guide the user interface, for example how you 


present information, navigate and 
control objects. 


Advant Plant Explorer 


This book describes how you build 


User’s Guide hierarchically structured models of a 
plant or project as well as how you 
navigate in the structures. 

Advant Graphics This book describes how you build and 

User’s Guide use graphics in Advant Workplace 


Products. It includes information about 
the basic building blocks provided by 
ABB. 


Advant Alarms 


This book explains how to use the 


User’s Guide Advant Alarm and Event functions. It 
covers alarm and event configuration 
and presentation. 

Advant Trends This book describes how to use the 

User’s Guide trend graphs to view historical data 


during runtime. 


Advant Reports Add-Ins 
User’s Guide 


This book describes how to include 
current and historical information in 
process reports 
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Table 1-2. Related Documentation (Continued) 


Category Title Description 
Options Advant Connectivity Library for Advant | This book is a set of pre-defined gra- 
Controller 100 Series phic elements for Advant Controller 100 
Reference Manual Series. 
Advant Graphic Library for Process This book is a set of pre-defined gra- 
Industry phics used by the process industry. 
Reference Manual 
Advant OPC Server for This guide describes the Advant OPC 
Advant Fieldbus 100 Server for Advant Fieldbus 100 (Advant 
User’s Guide OPC Server for AF100), which is a 
standard OPC interface for Advant 
Fieldbus 100. 
Advant History This book describes the Advant History 
User’s Guide software. 
Other Advant Workplace Products for This book is a presentation of the 


Operators 
Product Guide 


software and software options in Advant 
Workplace Products for Operators. It 
also includes hardware and software 
requirements and specifications. 


Advant Workplace Engineering Methods 
Reference Manual 


This book is intended as a guide for 
plant engineering using Advant 
Workplace Products software together 
with Advant Controller 100 Series. 


AdvaSoft 2.0 for Windows NT 
User’s Guide 


This is the operators manual and 
contains information on configuration 
and use of the AdvaSoft 2.0 for 
Windows NT. 
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1.5 Conventions 


The following conventions are used throughout this book for the presentation of 
material: 


The words in proper names of screen elements (for example, the title in the title 
bar of a window, the label for a field of a dialog box) are initially capitalized. 


Capital letters are used for the name of a keyboard key if it is labeled on the 
keyboard. For example, press the ENTER key. 


Lowercase letters are used for the name of a keyboard key that is not labeled on 
the keyboard. For example, the space bar, comma key, and so on. 


A plus sign is used to indicate that you must simultaneously press several keys. 
For example, CTRL+C indicates that you must hold down the CTRL key while 
pressing the C key. 


The phrase “press and release” is used to indicate that you sequentially press 
several keys. For example, to close a window, press and release ALT, and then 
F4. This indicates that you press and release the ALT key, and then you press 
and release the F4 function key. 


The names of push and toggle buttons are boldfaced. For example, click OK. 


The names of menus and menu items are boldfaced. For example, the File 
menu. 


— The following convention is used for menu operations: menuName > 
menultem > cascadedMenultem. For example: choose File > New > Type. 


— The Start menu name always refers to the Start menu on the 
Windows NT Task Bar. 


System prompts/messages are shown in the Courier font, and user 
responses/input are in the boldfaced Courier font. For example, if you enter a 
value out of range, the following message is displayed: 


Entered value is not valid. The value must be 0-30. 


In a tutorial, you may be told to enter the string TIC132 in a field. The string is 
shown as follows in the procedure: 


TIC132 
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1.6 Terminology 


The following is a list of terms associated with Advant Reports Add-Ins that you 


should be familiar with. 


Term 


Aspect 


Attributes 

Advant Reports Add-Ins 
Client 

Object 


Object Types 


History Object 
XLA 
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Description 


An aspect is a category of data associated with an object, for 
instance a TrendDisplay aspect may be associated with a 
plant area object. Aspects are opened to give access to their 
data. 


Object data that can be retrieved, for example: SETPOINT or 
VALUE 


A client that uses Microsoft Excel 97 as the Client container. 


A real plant object, for example a valve, is represented by an 
ABB Object in the Advant automation system. An ABB 
Object contains data describing the different aspects of it. 


Advant OCS object types as described in the Object Types 
Reference Manual. 


Historical Log 


Microsoft Compiled VBA Macros containing Advant 
Reports Add-Ins. 
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Chapter 2 Installation 


Installing Advant Reports Add-Ins is a two-step process: 


1. First, install the software. Advant Reports Add-Ins is a part of the AdvaSoft 2.0 
for Windows NT software package. The whole package is installed according 
instructions in the Advant Workplace Products Administrator’s Guide. 


2. Then add the Advant Reports Add-Ins to Excel97. See Section 2.1, Adding 
Add-Ins to Excel97. 


Once added to Excel97, the add-ins are ready to use. To get version and licensing 
information for the installed software, see Section 2.2, Product Verification. 


If you need to remove or re-install this software for some reason, see Section 2.3, 
Uninstalling Advant Reports Add-Ins. 
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2.1 Adding Add-Ins to Excel97 


Once the Advant Reports Add-Ins software has been installed, you must add the 
Advant Reports add-ins to Microsoft Excel. To do this: 


1. Launch Excel97. 
2. Choose Tools > Add-Ins from the Microsoft Excel menu bar, Figure 2-1. 


\ Microsoft Excel 


<M Book1 


[eal a: 


a | IERGE WOTKGGGKSy ry 


Add-Ins... 


Ls T 


Figure 2-1. Starting the Add-Ins Dialog in Excel 
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This displays the Add-Ins dialog, Figure 2-2. 


Add-Ins fea FS 
Add-Ins available; 


Analysis ToolPak 
[” Analysis ToolPak - VBA eee | 
T AutoSave 

(aeConditional Sum Wizard 

IV Internet Assistant Wizard __ Browse... | 
I Lookup Wizard 

I Microsoft Bookshelf Integration 

[— Template Utilities 

[7 Update Add-in Links 


M Web Form Wizard he 
onditional Sum Wizard 
Helps you create formulas to sum selected data in lists. 


Figure 2-2. Add-Ins Dialog 


Click the Browse button and then use the Browse dialog to navigate to: 
C:\Abb\Advant \AdvantReports\bin 


This is where the Advant Reports add-in file resides. 
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4. Select the AdvantReports.xl1la file, then click OK. This adds the Advant 
Reports Add-Ins to the list of available add-ins in the Excel Add-Ins dialog, 
Figure 2-3. 


Advant Add-Ins 

[7 Advantreportplugin 
Adyvantreports 
Analysis ToolPak 

7 Analysis ToolPak - VBA 


7 AutoSave 

T Book 

T Conditional Sum Wizard 
T File Conversion Wizard 
T Lookup Wizard 


Figure 2-3. Advant Add-Ins Added to List of Available Add-Ins 


5. With the Advantreports check box selected, click OK. This adds the 
AdvantReports Add-ins to the Excel menu and toolbar, Figure 2-4. 


| 100% =) 


Menu Add-Ins 


Toolbar Add-Ins 


Figure 2-4. Advant Add-Ins in the Excel Menu and Toolbar 
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2.2 Product Verification 


Go to the menu and choose AdvantReports> About, or click ABB on the toolbar. 
This displays an Advant Reports Add-ins information box with such information as 
software version. 


To close the box, just click inside it. 


2.3 Uninstalling Advant Reports Add-Ins 


If you need to re-install, or update the Advant Reports Add-Ins software (as part of 
AdvaSoft 2.0), you must: 


¢ Remove the Advant Reports Add-ins from Excel 


¢ Remove the AdvaSoft software from your computer. 


NOTE 
It is recommended that you remove the AdvantReports Add-ins 
before reinstallation. Once the add-ins and software have been 
removed, you can reinstall the software with either the same or 
updated media. 


To remove the AdvantReports Add-Ins from Excel, go to the Add-ins dialog as 
described in Section 2.1, Adding Add-Ins to Excel97, deselect the Advantreports 
Add-ins, then click OK. 


To remove the AdvaSoft software, refer to the Advant Workplace Products 
Administrator’s Guide. 
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Chapter 3 Configuration 


Configuration includes Populating Pick Lists for Object, Object Type, and Attribute 
and Setting Data Format and Communication/File Setup Options. 


3.1 Getting Started 


Populating Pick Lists for Object Types, Objects, and Attributes 


The data retrieval dialogs (Section 4.2, Dialogs for Ad-hoc Data Retrieval) have 
pick lists for selecting objects, object types, object attributes, and history objects. 
The contents of these pick lists are defined in (populated by) text files. 


Pre-defined text files are provided for you to use as a starting point. You can 
customize the contents of these pick lists to better fit your object/attribute selection 
requirements. This is done by creating new text files and then associating those text 
files with the corresponding pick lists. For details, see Section 3.2, Populating Pick 
Lists for Object, Object Type, and Attribute. 


Customizing Data Formatting, Communications, and File Set-up 


Data formatting, communications, and file setup options have default settings so 
you can begin using Advant Reports Add-Ins without having to do any preliminary 
set up. If you want to change any of these options, refer to Section 3.3, Setting Data 
Format and Communication/File Setup Options. 
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3.2 Populating Pick Lists for Object, Object Type, and Attribute 


Text files define the contents of the pick lists for Object, Object Type, Attribute, and 
History Object in the Ad-hoc data retrieval dialogs (Section 4.2, Dialogs for Ad-hoc 
Data Retrieval). The following standard files are provided for you: 


¢ For Object Type: OPCObj Types. txt 
e For Object: OPCObject .txt 


¢ For Attribute: OPCAttributesObjType.txt (where ObjType is the 
object type name, for example: OPCAttributesDAT AI.txt) 


A separate attribute text file is provided for each object type. When you select 
an object type in an ad-hoc data retrieval dialog, the attribute pick list will be 
populated with attributes from the OPCAt tributes text file having the same 
object type name. 


¢ For History Objects: OPCHistoryTags.txt 
¢ For Alarm/Event Objects: OPCAEObj Names .txt 
These text files are located in: c: \Abb\Advant \AdvantReports\config 


These default files are not complete, and are only intended as a starting point. You 
can create additional text files to meet your requirements. For instance, you can 
create a file structure such as the one shown in Figure 3-1 to follow your specific 
plant structure. 


BX Exploring - C:\TEMP\Plant7\Areal \Unit1 


[a Unit >| 


File Edit View Tools Help 


tal 3 [0] | 


All Folders Contents of 'C:\TEMPSPlant?\4 


16 


{) Plant? 
=| Areal 


= Unit | Object Text Files 
ex | Unit 
= apa for Areai-Unit1 


=| Area? 


(D Unit3 
£2 Unit4 


eactor1 txt 
eactor2. txt 


oe ee 


Figure 3-1. Organizing Text Files According to The Plant Structure 
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Follow these guidelines to create a new file. Use the standard files for reference. 


File Naming and Directory Structure 


There are no special file naming requirements. Follow Windows NT or Windows 95 
conventions. You are not required to put the text files in a specific directory. 


General File Syntax and Format 


Enter one item (object, object type, attribute, or history object) per line. 


Object File Format 


When you create an object text file, you can associate a specific object type with 
each object. To do this, use the following format: object name, object type 


For object name, enter just the part of the OPC tag name to the left of the 
object:attribute separator. For instance, if the tag name is 
AC70_DAT_AI1:VALUE, enter: AC70_DAT_ATI1. The attribute part is appended 
to the object name with the appropriate Separator when you select from the 
Attribute pick list. 


When you associate a specific object type with an object, the object will only be 
included in the Object pick list when the corresponding Object Type is selected. 


If you do not associate an object type with an object, the object will always be 
included in the Object pick list, no matter which type is chosen. If you enter an 
object without a type, DO NOT enter a comma (,) after the object name. 


Naming History Objects 


For History Object text files, use the composite log name or numeric log name, 
including Separators. Refer to the Advant History User’s Guide for details. 


Applying New Default Files 


Use the File Setup area of the Options dialog Defaults tab to specify new default 
files. For details, refer to Section 3.3.2, Defaults. The Object File and History 
Object File fields may be left blank. This forces the user to select an object file. 
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3.3 Setting Data Format and Communication/File Setup Options 


The Options dialog is displayed when you click the Options button, or choose 
AdvantReports > Options from the Microsoft Excel menu bar. 


Use the Data Format tab to configure orientation and data options. For instance, 
this tab lets you specify whether or not to include attribute names as headers, and 
whether to orient the list horizontally, or vertically. 


Use the Defaults tab to establish defaults for communications settings and File 
setup. File setup refers to selecting the default text files for the Object, Object Type, 
Attribute, and History object lists in the data retrieval dialogs. 


3.3.1 Data Format 


18 


Use this tab to specify: 

¢ — whether or not you want to show Attributes as Headers. 

¢ whether or not to use Long Format 

¢ whether to use a Horizontal List or Vertical List 

¢ — whether or not to include Headers 

¢ whether or not to show Object names 

¢ whether or not to provide a Time Stamp for each entry in the list 


e — the Data Mask Format for the Time Stamp (if you choose to include the time 
stamp) 


¢ whether or not to include Attribute Names 
e whether or not to provide an indication for History Data Quality 


¢ if you choose to provide an indication for History Data Quality, whether to use 
Symbolic or Numeric Indicator for History Data Quality 
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Attributes as Headers 


When this orientation option is selected, the names of the selected attributes are 
used as column headers (for Horizontal List) or row headers (for Vertical List). An 
example for a horizontal list is shown in Figure 3-3. 


Object Name Time Stamp VALUE STATUS 
AC?70_22_DAT_Al1 11/16/99 17:31:31 18 1 
AC70_22_DAT_Al2 11/16/99 17:31:31 62 1 
AC?70_22_DAT_AI3 11/16/99 17:31:31 21.25 1 


Figure 3-2. Example, using Attributes as Headers 


Long Format 


When this orientation option is selected, object attributes are presented in the long 
format with Attribute and Data Value headings. A long format example is shown 
in Figure 3-4. 


Object Name Time Stamp Attribute Data Value Attribute Data Value 
AC?O_22 DATA 11/16/99 17:33:53 YALUE 19 STATUS 1 
AC?70_22 DAT_Al2 11/16/99 17:33:53 VALUE -66.5 STATUS 1 
AC?0_22 DAT_AIS 11/16/99 17:33:53 VALUE 67.5 STATUS 1 


Figure 3-3. Example, Long Format 


Horizontal List 


If you choose Horizontal List, attributes are listed horizontally and objects are listed 
vertically. An example is shown in Figure 3-3. 
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Vertical List 


If you choose Vertical List, attributes are listed vertically and objects are listed 
horizontally. An example is shown in Figure 3-5. 


ObjectName —_ AC70_22 DAT_All |AC70_22 DAT_Al2 AC70_22 DAT AG 


Time Stamp 11/16/99 17:35:25) 11/16/99 17:35:25 11/16/99 17:35:2 
VALUE 7 71 -46.2 
STATUS | | 


Figure 3-4. Example, Vertical List 


Headers 


When this option is selected, headers are included in the list. 


Object names 


When this option is selected, object names are shown; otherwise, they are excluded. 


Time Stamp 


When this option is selected, a time stamp is provided for values that have an 
associated time stamp, for instance History objects. 


Data Mask Format 
This field lets you specify the time stamp format. 


Attribute Names 


When this option is selected, the names of the selected attributes are shown. 


History Data Quality 


When this option is selected, a data quality indication is provided for History object 
values according to the selected format (Symbolic or Numeric Indicator for History 
Data Quality). 
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Symbolic or Numeric Indicator for History Data Quality 


When History Data Quality is enabled, you can choose to show data quality 
symbolically, or numerically. 


When you choose Symbolic, data quality is indicated as OK (good) or ??? (bad or 
unknown). 


When you choose Numeric, data quality is indicated as a numeric error code. 


3.3.2 Defaults 
This tab lets you: 


¢ — configure the following Communications Settings: 
— Timeout 
— Write Debug File 
— Disable Functions 
¢ specify the default text files for: 
— Object Type File 
— Object File 
— Attribute File 
— History Object File 
¢ configure these OPC Server settings: 
— Separator 


—  OPCServer 


Current Channel 


This setting is not applicable for this version of Advant Reports Add-Ins. 
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Port Number 
This setting is not applicable for this version of Advant Reports Add-Ins. 


Timeout 


This is the maximum time that Advant Reports Add-Ins will wait for the specified 
object to respond to a query before timing out. 


Write Debug File 


When this feature is selected Advant Reports Add-Ins writes to a text file that you 
can refer to when troubleshooting. The file name is debug.txt and is located in: 


c: \Abb\Advant \AdvantReports\debug 


Disable Functions 


When this check box is selected, all Advant Reports Add-Ins functions in the Excel 
spreadsheet are disabled. Functions must be disabled when you insert functions as 
described in Section 4.3, Building and Running Reports. The functions must be 
enabled when you execute a specific function, or calculate the entire workbook. 


Object Type File 


This is the name of the text file that populates the Object Type pick list. Advant 
Reports Add-Ins comes with a standard object type text file. This standard file 
DOES NOT include all object types. The file are intended to be a starting point. You 
can create additional object type text files as described in Section 3.2, Populating 
Pick Lists for Object, Object Type, and Attribute. 
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Object File 


This is the name of the default object text file for all data retrieval dialogs that have 
an Object File field. This along with the selected Object Type determine the list of 
available objects in the object list. 


You can use the Object File pick list in data retrieval dialogs to select a different text 
file. Advant Reports Add-Ins comes with a standard object text file. This standard 
file DOES NOT include all objects The file is intended to be a starting point. You 
can create custom object text files as described in Section 3.2, Populating Pick Lists 
for Object, Object Type, and Attribute. 


Attribute File 
This is the name of the text file that populates the Attribute pick list. 


Advant Reports Add-Ins comes with a number of standard attribute text files. These 
standard files DO NOT include all attributes. These files are intended to be a 
starting point. You can create custom attribute text files as described in Section 3.2, 
Populating Pick Lists for Object, Object Type, and Attribute. 


History Object File 


This is the name of the default object text file for the History Value and Multiple 
History Value dialogs. You can use the Object File pick list in these dialogs to select 
a different text file. 


Advant Reports Add-Ins comes with a standard history object text file. You can 
create custom history object text files as described in Section 3.2, Populating Pick 
Lists for Object, Object Type, and Attribute. 


Separator 


This lets you specify the separator (delimiter) between the object name and attribute 
name. This may vary, depending on the OPCServer you are connecting to. 
Typically, data collection is via the Advant OPC server. In this case the correct 
separator is a colon (:), for example: AC70_22_DAT_AI1:VALUE. 
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OPCServer 


This lets you specify the OPC server to connect to. A number of pre-determined 
OPC servers are supported. These are defined in a configuration file. To view and/or 
modify this configuration file, see Appendix A, Configuring OPC Server Access. 
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Chapter 4 Operation 


Operation includes working with Dialogs for Ad-hoc Data Retrieval, and Building 
and Running Reports. 


4.1 Getting Started 


Learning the basics 


It is recommended that you take a quick look at Section 4.1.1, User Interface to get 
acquainted with the toolbar and menu items that have been added to the Excel 
application to support Advant Reports Add-Ins. 


Populating Pick Lists for Objects, Object Types, and Attributes 


The data retrieval dialogs have pick lists for selecting objects, object types, object 
attributes, and history objects. The contents of these pick lists are defined in text 
files. Pre-defined text files are provided for you to use as a starting point. 


You can customize the contents of these pick lists to better fit your object/attribute 
selection requirements. This is done by creating new text files and then associating 
those text files with the corresponding pick lists. 


For detailed instructions, refer to Section 3.2, Populating Pick Lists for Object, 
Object Type, and Attribute. 


Customizing Your Application 


Options for data formatting, communications, and file setup have default settings so 
you can begin using Advant Reports Add-Ins without having to do any preliminary 
set up. If you want to change any of these settings, refer to Section 3.3, Setting Data 
Format and Communication/File Setup Options. 
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Making Ad-hoc Queries 


To generate ad-hoc requests for data, refer to: 


Section 4.2.1, Retrieving the Current Value for a Single Process Object 
Section 4.2.2, Retrieving the Current Value for Multiple Process Objects 
Section 4.2.3, Retrieving History Values for a Single History Log 
Section 4.2.4, Retrieving Values for Multiple History Logs 


Section 4.2.5, Retrieving Alarm and Event Data 


Building and Running Reports 


The Advant Reports Add-Ins functions provide the same data retrieval capabilities 
as the dialogs, except that the functions can be re-executed by running the 
spreadsheet. The results can be saved, archived, printed and rerun.To build and run a 
report for Advant OCS data, refer to Section 4.3, Building and Running Reports. 


To associate a report with a plant object, see Section 4.3.3, Associating Reports with 
Plant Objects. 
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4.1.1 User Interface 


The user interface for Advant Reports Add-Ins is embedded in the Excel user 
interface. When you install Advant Reports Add-Ins, AdvantReports Add-Ins are 
added to the toolbar and menu bar, Figure 4-1. 


Toolbar 


Add-Ins Menu Add-Ins 


3 | AdvantReports 


About 


- Process Values > a8 
im History Yalues > wz 
- Options 

AlarmEvents 


1 ee ee ee ae 


Figure 4-1. Toolbar Buttons for Advant Reports Add-Ins 


4.1.1.1 AdvantReports Add-ins 


Process Values 


The Process Values button, Figure 4-2, displays a dialog that lets you retrieve the 
current value for a single process object (tag). As an alternative you can choose 
AdvantReports > Process Value>Single from the menu bar. See Section 4.2.1, 
Retrieving the Current Value for a Single Process Object. 


Process Value Button 


|| abe | 4 HE 


fa 


om ta |) |) 


Figure 4-2. Process Value Button 
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The Multiple Process Values button, Figure 4-3, displays a dialog that lets you 
retrieve the current values for multiple process objects. As an alternative you can 
choose AdvantReports > Process Value>Multiple from the menu bar. See Section 
4.2.2, Retrieving the Current Value for Multiple Process Objects. 


Multiple Process Values Button 


om fa | 


|| ABB | Sq HE 


Figure 4-3. Multiple Process Values Button 


History Values 


The History Values button, Figure 4-4, displays a dialog that lets you retrieve 
historical values for a single history object (log). As an alternative you can choose 
AdvantReports > History Value>Single from the menu bar. See Section 4.2.3, 
Retrieving History Values for a Single History Log. 


The Multiple History Values button, Figure 4-4, displays a dialog that lets you 
retrieve historical values for multiple history objects. As an alternative you can 
choose AdvantReports > History Value>Multiple from the menu bar. See Section 
4.2.4, Retrieving Values for Multiple History Logs. 


History Value Button Multiple History Values Button 
Loe 
ate | Sq HE) Sin Se | A |) 


Figure 4-4. History Value Button 
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Options 


The Options button, Figure 4-5, displays the Options dialog for setting up data 
format, communications, and file setup options. As an alternative you can choose 
AdvantReports > Options from the menu bar. See Section 3.3, Setting Data 
Format and Communication/File Setup Options for details. 


Options Button 


jae | Sq ez | Son Ses | 1 | cD 


Figure 4-5. Options Button 


AlarmEvents 


The AlarmEvents button, Figure 4-6, displays the AlarmEvents dialog that lets you 
retrieve alarm and event data. As an alternative you can choose AdvantReports > 
AlarmEvents from the menu bar. See Section 4.2.5, Retrieving Alarm and Event 
Data for details. 


AlarmEvents Button 


lane | Sq ez | So Ses | 1 | cD 


Figure 4-6. AlarmEvents Button 


The Advant Add-ins are buttons and menu items for: About, Process Values, 
History Values, Options. 
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About 


The ABB (About) button displays the About dialog, Figure 4-7. As an alternative 
you can choose AdvantReports > About from the menu bar. 


About Advant Reports Button 


About Advant Report Plug_Ins 


Figure 4-7. About Button 
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4.2 Dialogs for Ad-hoc Data Retrieval 
These dialogs let you generate ad-hoc data requests for: 
¢ Retrieving the Current Value for a Single Process Object 
* Retrieving the Current Value for Multiple Process Objects 
* Retrieving History Values for a Single History Log 
¢« Retrieving Values for Multiple History Logs 
¢ Retrieving Alarm and Event Data 


When you use these dialogs, you can not use the F9 function to re-calculate the 
workbook and retrieve new data. To create a workbook that can be re-calculated on- 
demand for reporting purposes, you must use Advant Reports Add-Ins functions. 
See Section 4.3, Building and Running Reports. 


All dialogs have a similar layout, Figure 4-8. There are a number of widgets that are 
common to most of the dialogs. These common widgets are Object File, Start Cell, 
Object Type, Object, Attribute, Insert, and Values (the Values widget is not included 
in the Process Value dialog). 


Process Value 


Reports‘\config\OPCO bject. txt ) ago 
L_| 
Jor 


AC70_22 DAT_AI ¥ 


Figure 4-8. Typical Data Retrieval Dialog 
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Object File 


An object file is a text file that contains a list of object names. The object file that 
you select in this field determines the contents of the Object pick list. The default 
object file specification is set via the Defaults tab in the Options dialog. You can use 
the Browse button associated with this field to change the object file specification. 


One object file is provided with Advant Reports Add-Ins as standard. This file does 
not include all object names for your application. You can edit this file, and create 
additional object files to customize object selection for your application. For details, 
see Section 3.2, Populating Pick Lists for Object, Object Type, and Attribute. 


Start Cell 


This field indicates the starting cell for data returned by the query. The initial Start 
Cell value is based on which cell in the spreadsheet is selected when you open the 
dialog. You can change the initial Start Cell value by entering a new value directly 
in this field. 


The syntax is ColumnLetterRowNumber. For example D4 is the fourth row in the 
fourth column. 


The orientation of the data is set via the Data Format tab in the Options dialog. If 
you choose Horizontal List, attributes are listed horizontally and objects are listed 
vertically. If you choose Vertical List, attributes are listed vertically and objects are 
listed horizontally. See Section 3.3, Setting Data Format and Communication/File 
Setup Options. 


Object Type 


Specify the object type in this field. You can enter the object type directly in this 
field, or use the corresponding pick list. 


The list of available object types is determined by the object type text file specified 
in the Defaults tab of the Options dialog. See Section 3.3, Setting Data Format and 
Communication/File Setup Options. 
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Object 


You can enter the object name directly in this field, or use the corresponding pick 
list to select from a list of available objects. 


For object name, enter just the part of the OPC tag name to the left of the 
object:attribute separator. For instance, if the tag name in the OPC database is 
AC70_22_DAT_AI1:VALUE, enter: AC70_22_DAT_AI1. The attribute part is 
appended to the object name with the appropriate Separator when you select from 
the Attribute pick list. 


The list of available objects is determined by the specified Object File and Object 
Type. The pick list includes all objects listed in the selected Object File that match 
the selected Object Type, or that have no Object Type association. For details, refer 
to Section 3.2, Populating Pick Lists for Object, Object Type, and Attribute. 


Attribute 


Specify the object attribute in this field. This is the part of the OPC tag name to the 
right of the Separator. For instance, if the tag name is AC70_22_DAT_AI1: VALUE, 
enter: VALUE. 


You can enter the attribute name directly in this field, or use the corresponding pick 
list. The list of available attributes is determined by the attribute text file specified in 
the Defaults tab of the Options dialog, or by the selected Object Type. 


Values 


For History data retrieval, queries can be made in such a way that the number of 
objects to return data for is undetermined, or unmanageable. The Number of Values 
field lets you set the maximum number of responses to a manageable quantity. 


You can enter an integer value directly in this field, or use the corresponding pick 
list. The pick list choices are: All, 1, 50, 100, 200, 300, 400, 500. If you enter the 
number of values directly, the largest possible number is 9999. For History queries, 
you can ask for 9999 values; however, a maximum of 500 will be returned. 
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Insert 


The Insert function lets you insert a new row or rows of data in the spreadsheet 
without overwriting any existing data. When the Insert function is selected, existing 
rows are moved down as required to make room for the new data. Not selecting this 
check box, may result in existing cells being overwritten by new data. 


Apply, OK, & Cancel Buttons 


These dialogs have an Apply button and an OK button. Use Apply when you want 
the dialog to remain open after you execute a query, so you can continue to work 
with the dialog. Use OK when you want to close the dialog after you apply your 
entries. 


NOTE 


The OK button always executes the query that is currently 
specified in the dialog, so if you have executed several queries 
using the Apply button, and then you use the OK button to 
close the dialog, the last query entered will be executed again. If 
you do not want to re-execute the query, use the Cancel button 
to close the dialog. 
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4.2.1 Retrieving the Current Value for a Single Process Object 


To display the current value for a process object in your Excel Spreadsheet: 
1. Click on the starting cell where you want to display the query result. 


2. Either click the Process Value button, or choose 
AdvantReports > Process Values>Single from the menu bar. This displays 
the Process Value dialog. 


3. The selected starting cell is indicated in the Start Cell field. You can use this 
field to change the Start Cell if necessary. 


4. Click the Insert check box if you need to ensure that existing data are not 
overwritten by new data. 


5. Use this dialog to specify object whose process value you want to retrieve. 
Select the Object File and Object Type first to ensure proper object filtering. 
Then select the Object and Attribute. 


To change any of the data format or orientation options, click the Options button to 
display the Options dialog. Refer to Section 3.3, Setting Data Format and 
Communication/File Setup Options for details. 


4.2.2 Retrieving the Current Value for Multiple Process Objects 


This procedure is essentially the same as for Retrieving the Current Value for a 
Single Process Object. To display the Multiple Process Values dialog, either click 
the Multiple Process Values button, or choose AdvantReports > Process 
Values>Multiple from the menu. 


Select the Object File and Object Type first to ensure proper object filtering. To 
select objects and attributes one-at-a-time, first click the name in the list of available 
objects/attributes on the left and then click the corresponding > button (or simply 
double-click the applicable name). This puts the selected object/attribute in the list 
of selected objects/attributes on the right. You can use the appropriate < button to 
move selected objects/attributes back to the list of available objects/attributes. 


To select all objects or attributes, simply click the corresponding >> button. This 
moves all objects or attributes from the list of available objects/attributes on the left, 
to the list of selected objects/attributes on the right. You can use the << button to 
move all objects/attributes back to the list of available objects/attributes. 
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You can use the up and down arrows associated with the selected objects and 
selected attributes lists to adjust the presentation order. 


To change any of the data format or orientation options, click the Options button to 
display the Options dialog. Refer to Section 3.3, Setting Data Format and 
Communication/File Setup Options for details. 
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4.2.3 Retrieving History Values for a Single History Log 
To display historical values for a selected history log in your Excel Spreadsheet: 
1. Click on the starting cell where you want to display the query result. 


2. Click the History Values button, or choose AdvantReports > History 
Values>Single from the menu bar. This displays the History dialog. 


The starting cell is indicated in the Start Cell field. You can change the Start Cell if 
necessary. Specify the: Object File, Object, Log Calculation Algorithm, Time Span 
for Retrieval, and number of Values. Use the Shift Time Span buttons to shift the 
time span forward and backward. 
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Log Calculation Algorithm 


This menu lets you select a log in the composite log hierarchy that performs a 
specific calculation. The choices are: 


Any retrieves data from log according to seamless retrieval algorithm. 
When the exact log is a composite log hierarchy is not specified, 
this algorithm selects the most appropriate log for you. Refer to the 
Advant History User’s Guide for details. 


Mean retrieves data from log that calculates the mean value. 
Max retrieves data from log that calculates the maximum value. 
Min retrieves data from log that calculates the minimum value. 


Time Span for Retrieval 


Specify the time span for retrieval of historical data by entering a starting and 
ending dates and times in the Month, Day, Year, and Time fields. To adjust time 
units (hours, minutes, seconds, AM/PM), first click on the applicable unit before 
you use the up/down arrows. 


You can use the Duration menu in combination with the Minutes, Hours, Days, 
and Weeks radio buttons to adjust the time span. For instance, assume the time span 
is set for one week: 


End Time = November 7 1998 08:00:00 AM 
Start Time = October 31 1998 08:00:00 AM 


If you select the Hours radio button, and then choose 12 from the Duration menu, 
the span will change from one week to 12 hours: 


End Time = November 7 1998 08:00:00 AM 
Start Time = November 6 1998 08:00:00 PM 


You can shift the specified time span forward and backward via the Shift Time Span 
buttons. 
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Shift Time Span 


These buttons let you shift the time span forward and backward. First select the 
units (Minutes Hours, Days, Weeks) and the number of steps (each step = 1 unit). 
Then use the buttons to shift the time span forward and backward: 


< Shift time span backward 1 times the number of steps 
<< Shift time span backward 2 times the number of steps 
> Shift time span forward | times the number of steps 
>> Shift time span forward 2 times the number of steps 


4.2.4 Retrieving Values for Multiple History Logs 


This procedure is essentially the same as for Retrieving History Values for a Single 
History Log, with the following exceptions. 


To display the Multiple History Values dialog, either click the Multiple History 
Values button, or choose AdvantReports > History Values>Multiple from the 
menu bar. 


Rather than selecting a single Object, you can select any number of objects from the 
list of available objects: 


¢ — To select one item at a time, click on the corresponding line. 


¢ — To select multiple contiguous items, click on the first item you want to select, 
hold down the SHIFT key, and then click on the last item you want to select. 


¢ To select multiple items that are not contiguous, hold down the CTRL key and 
click on the items you want to select. 
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4.2.5 Retrieving Alarm and Event Data 


An example result from an alarm query is shown in Figure 4-13. 


BSE HA KL | My DB) t00% - | Bila) 5 a 


FS %, a - o-AY 


SH SERY BRS O-o- 


| “0+ BIUEs 


F4 hd DATA, QUALITY 

A B C D E a a Ee 
Message Time ObjectName Priority Message Desc Condition Sub Condition Ack Time Ack S 
05/27/99 11:54:54 202CONTROL 16 MOD SETPOINT RATE OF CHANGE Unack 
05/27/99 11:55:11 PUMP1 70 HamlettAndEggs MOD MEASURE HIHI Unack 
05/27/99 11:55:14 PUMP1 31 MOD OUTPUT [DATA QUALITY | Unack 
05/27/99 11:55:31 202CONTROL 135 HamlettAndEggs MOD SETPOINT RATE OF CHANGE Unack 
05/27/99 11:55:34 202CONTROL 146 MOD MEASURE LOLO Unack 


Figure 4-9. Example, Alarm Query Result 


To display alarm and event data in your Excel Spreadsheet: 
1. Click on the starting cell where you want to display the query result. 


2. Either click the AlarmEvent button, or choose AdvantReports > AlarmEvent 
from the menu bar. This displays the AlarmEvent dialog. 


3. The selected starting cell is indicated in the Start Cell field. You can use this 
field to change the Start Cell if necessary. 


Use this dialog to specify the: number of Values, Filter Options, and Sorting 
Options. 


To revert back to the default specification, click the Default button. 
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4.2.5.1 Filter Options 


The filter options lets you limit the scope of alarm and event messages to be 
retrieved retrieval based on any combination of the following criteria: Message 
Type, Time Range, Object Name, Priority Range, and Acknowledge State. 


Message Type 


Use this field to specify whether to retrieve alarm messages or event messages. 


Time 


The time specification has two parts. First specify whether to retrieve messages 
based on the time when the messages occurred, or when the messages were 
acknowledged (only applicable for alarm messages). Then use the From and To 
fields to specify the starting and ending times to retrieve messages for. 


Object Name 


This field lets you retrieve messages based on object name. The default is all object 
names as indicated by the asterisk (*). To narrow the scope of object names, you can 
enter either the beginning characters or ending characters in combination with the 
asterisk. For example: 


¢  TC* will retrieve messages for all objects with the TC prefix. 
¢ *AREAI1 will retrieve all messages for objects with the AREA suffix. 


¢ TC*AREA1 will retrieve all messages for objects with the TC prefix and 
AREA| suffix. 


You can also use the pick list to select an object name. The list of names available in 
this field is specified by selecting the alarm/event object names text file via the 
AEObjNamefile button. This button displays a dialog to let you navigate to the 
directory where object text files are located. 


Priority 


Use the Priority (From) and Priority (To) fields to retrieve only messages within a 
specified priority range. The limits are: 1000 for most urgent to 1 for least urgent. 
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Acknowledge State 


This field lets you retrieve just acknowledged messages, just unacknowledged 
messages, or both acknowledged and unacknowledged messages. 


4.2.5.2 Sorting Options 


44 


The sorting options let you sort the resulting message list based on up to three of the 
following sorting criteria: Message Time, Priority, Condition, Sub Condition, 
Object Name, Acknowledge Time, Acknowledge State. 


You can exclude one or more of these sorting criteria by setting the value to None. 
Selected criteria are shown in the Sorting Options list. This list indicates the order of 
precedence for each criteria. 


Precedence is based on the order in which you select the criteria, with the last 
selected criteria having precedence over the previously selected criteria. For 
instance, if you select Condition, then Message Time, then Priority, the list will be 
sorted first by Priority, then by Message Time, and last by Condition. 


You can select up to three sorting criteria. If you try to select a fourth criteria, the 
first selection will be dropped from the list. 


Message Time 


Sort by message time from Oldest to Newest, or Newest to Oldest. If you choose 
None, this criteria is not used for sorting. 


Priority 


Sort by priority from High to Low, or Low to High. If you choose None, this 
criteria is not used for sorting. 


Condition 


Sort by object attribute in Ascending to Descending alphanumeric order, or 
Descending to Ascending alphanumeric order. If you choose None, this criteria is 
not used for sorting. 
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Sub Condition 


Sort by alarm condition in Ascending to Descending alphanumeric order, or 
Descending to Ascending alphanumeric order. If you choose None, this criteria is 
not used for sorting. 


Object Name 


Sort by object name in Ascending to Descending alphanumeric order, or 
Descending to Ascending alphanumeric order. If you choose None, this criteria is 
not used for sorting. 


Acknowledge Time 


Sort by acknowledge time from Oldest to Newest, or Newest to Oldest. If you 
choose None, this criteria is not used for sorting. 


Acknowledge State 


Sort based on whether the alarms are acknowledged or unacknowledged. If you 
choose None, this criteria is not used for sorting. 
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4.3 Building and Running Reports 


You can insert the following Advant Reports Add-Ins function calls in an Excel 
spreadsheet to build a report: 


¢ | ABBGetObj - retrieves the specified attribute value for the specified object. 


¢ ABBGetHistory - retrieves a specified number of values for the specified 
historical log object. 


To build and run reports, refer to: 

¢ Section 4.3.1, Setting Up a Report. 

¢ Section 4.3.2, Rerunning A Report 

e¢ Section 4.3.3, Associating Reports with Plant Objects. 


4.3.1 Setting Up a Report 


This involves inserting the functions, and executing the functions at least once as 
you insert them. 


NOTE 


While the cursor is in the formula bar, pressing F9 after 
inserting or changing a function will cause Excel to hang. 


To insert a function call, the workbook must be in manual mode. See Section 
4.3.1.1, Putting the Workbook in Manual Mode. You can either use the Excel 
Function wizard, or you can insert function calls manually. 


e To use the Excel Function Wizard, see Section 4.3.1.2, Using the Function 
Wizard. 


¢ To insert functions manually, see Section 4.3.1.3, Inserting Functions 
Manually. 
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4.3.1.1 Putting the Workbook in Manual Mode 


When you use one of these functions in an Excel spreadsheet, make sure that your 
workbook calculation mode is set to Manual. To do this: 


1. Choose Tools > Options from the Excel menu bar. This displays the Excel 
Options dialog. 


2. Click the Calculation tab. 


3. Select the Manual calculation option and click OK, Figure 4-15. 


Dptions HEF 
Transition Custom Lists Chart Color 
View Calculation | Edit General 
Calculation 


Automatic @ Manual: Cale Now (F9)_| 
( Automatic except tables IV Recalculate before save 
Calc Sheet | 


"Iteration 
Maximum iterations: 100 Maximum change: fo 001 
Workbook options 
IV Update remote references IV Save external link values 
T Precision as displayed IV Accept labels in formulas 


T 1904 date system 


cone 


Figure 4-10. Excel Options Dialog, Calculation Tab 
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4.3.1.2 Using the Function Wizard 


You may use the Excel function wizards as templates to set up your functions then 
run them later. To do this: 
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1. Make sure the workbook is in Manual calculation mode as described in Putting 
the Workbook in Manual Mode. 

2. Make sure the Disable Functions checkbox is checked on the Add-ins Options 
dialog. See Defaults under Section 3.3, Setting Data Format and 
Communication/File Setup Options. 

3. Select a cell in the spreadsheet. 

4. Choose Insert > Function from the Excel menu bar (or click the Function 
button on the Excel toolbar). This displays the Paste Function dialog. 

5. Select User Defined from the Function category list on the left. This displays 
the Advant Reports Add-Ins functions in the Function name list on the right, 
Figure 4-16. 

Paste Function 24x! 
Function category: Function name: 


ABBGetObj(objecttype Object atribute) 
Choose the Help button for help on this Function and its arguments. 


Date & Time DebugEnabled 
Math & Trig GetFullPath 
Statistical 


Lookup & Reference 
Database 

Text 

Logical 

Information 


ABBGetHistor 


ABBGetObj 


Figure 4-11. Paste Function Dialog 
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6. Select the function that you want to insert. This displays a dialog for specifying 
the selected function’s parameters. For example, if you selected ABBGetObj, 
the dialog shown in Figure 4-17 is displayed. 


Figure 4-12. Function Specification Dialog 


7. Enter a specification for each parameter. Be sure to embed text strings (for 
instance object names) in double quotes. Refer to the applicable function 
description for details (ABBGetObj, ABBGetHistory). 


8. Click OK when you are finished with the Parameters dialog. 
9. Repeat steps 3-8 for as many functions as you need to insert. 


10. Go back to the Add-ins Options dialog, and un-select the Disable Functions 
option. See Defaults under Section 3.3, Setting Data Format and 
Communication/File Setup Options. 
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11. 


You must execute each function once, before you can use the F9 key to 
calculate the entire workbook. 


For each ABBGetHistory function you must do the following to execute the 
function for the first time: 


a. Select the cell where the function is defined. 


b. Starting with that cell, select a range of cells where the data will be 
entered. 


c. Put the cursor in the formula bar. 
d. Press CTRL+SHIFT+ENTER to execute the function for the first time. 
e. Repeat steps a-d for each ABBGetHistory function. 


For each ABBGetObj function you must do the following to execute the 
function for the first time: 


a. Select the cell where the function is defined. 
b. Put the cursor in the formula bar. 
c. Press ENTER to execute the function for the first time. 


d. Repeat steps a-c for each ABBGetObj function. 


4.3.1.3 Inserting Functions Manually 
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For ABBGetHistory functions: 


iif 


Make sure the workbook is in Manual calculation mode as described in Putting 
the Workbook in Manual Mode. 


Select a range of cells. For example, for ABBGetHistory, you may select an 
area on your worksheet that is 3 columns wide and 500 rows long. 


Enter the function according to the function syntax. Refer to ABBGetHistory 
for details. 


Each parameter must be separated by a comma. Strings must be in double- 
quotes ("). 
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4. With the cursor in the formula bar, press CTRL+SHIFT+ENTER to run the 
function. This causes the selected area to be treated as an array, and as one 
function. 


For AbbGetObj functions: 


1. Make sure the workbook is in Manual calculation mode as described in Putting 
the Workbook in Manual Mode. 


2. Selecta cell. 


3. Enter the function according to the function syntax. Refer to ABBGetObj for 
details. 


Each parameter must be separated by a comma. Strings must be in double- 
quotes ("). 


4. Press ENTER to run the function. 


4.3.1.4 Saving a Report 


The first time you save a report, use the File>Save As command from the Excel 
menu bar. This lets you enter a unique name for the report, and specify the path 
where you want to save the report to. 


Each time you run the report, if you want to save multiple instances, use File>Save 
As to enter a unique name for each instance. 


If you do not need to save each instance, use File>Save instead. 


4.3.1.5 ABBGetObj 


The ABBgetObj function retrieves the specified attribute value for the specified 
object. The syntax for ABBGetObj is: 


=ABBGetObj(Object Type, Object, Attribute) 
Enter all parameters as text strings with double-quotes. 
Example: 


=ABBGetObj (“DAT AI”, “AC70 22 DAT AT1”, “VALUE”) 
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4.3.1.6 ABBGetHistory 
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The ABBGetHistory function retrieves a specified number of values for the 
specified historical log object. By default this function retrieves 3 columns of data: 


¢ Time Stamp 
¢ History Data Quality Indication 
e Value 


You can turn off the Time Stamp and/or History Data Quality indication via the 
Options dialog. See Section 3.3.1, Data Format for details. 


The syntax for ABBGetHistory is: 


=ABBGetHistory(Object, Log Calculation Algorithm, Start Time, End Time, 
Values) 


Object, interpolation parameter, start time, and end time are text strings and must be 
entered with double quotes. For start time, and end time, the date and time must be 
separated by a space. Values is an integer. 


Example: 


=ABBGetHistory (“FC3051:VALUE”, “max”, "11/3/98 14:30", 
“11/3/98 19:30”, 5) 


Matching the Number of Returned values with the Number of Rows Selected 


The number of values returned by the ABBgetHistory function is determined by the 
Values parameter, and by the number of rows you select in the Excel spreadsheet 
(step 2 in Section 4.3.1.3, Inserting Functions Manually). 


° If Values > selected rows, the excess values are truncated. 


° If Values < selected rows, the excess rows are filled in with N/A (not 
applicable). 


You can use the Values parameter to make the number of values returned match the 
number of rows selected. To do this specify the Values parameter as -1. For 
example: 


=ABBGetHistory (“FC3051:VALUE”, “max”, "11/3/98 14:30", 
“11/3/98 19:30”, -1) 
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Again, if there are less values in the log than there are rows specified, the excess 
rows are filled in with N/A. 


NOTE 


The maximum number of values that can be returned in one call 
is 500. 


4.3.2 Rerunning A Report 


When you build a report, you must execute each function individually before you 
can use F9 to calculate the entire workbook. This is described as part of the 
procedure in either Section 4.3.1.2, Using the Function Wizard, or Section 4.3.1.3, 
Inserting Functions Manually. Once all the functions in the report have been run at 
least once, you can use the F9 key to calculate the entire workbook. 


NOTE 


While the cursor is in the formula bar, pressing F9 after 
inserting or changing a function will cause Excel to hang. 


To execute an individual function within a report: 


¢ Fora ABBGetHistory function select the cell where the function is defined, put 
the cursor in the formula bar, and then press CTRL+SHIFT+ENTER. 


¢ Fora ABBGetObj function select the cell where the function is defined, put the 
cursor in the formula bar, and then press ENTER. 
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4.3.3 Associating Reports with Plant Objects 


You can associate a report with plant objects in the Plant Explorer. To do this, you 
must create a report aspect for the object that points to the workbook (.xls) file. 
Having created this aspect, you can open it in the Plant Explorer to launch Excel 
with the specified workbook. 


General instructions for adding aspects are provided in the Advant Plant Explorer 
User’s Guide. Use these guidelines to create an aspect for an Excel workbook: 


¢ — Follow the procedure in the Advant Plant Explorer User’s Guide for creating a 
Windows Application aspect type. An aspect of this type lets you launch a 
specified Windows application, in this case, Excel. 


* Using the Config View function for the new aspect. Do the following: 
— Put the path to Excel in the Windows Application: field. For example: 
C:\Program Files\Microsoft Office\Office\excel.exe 


— Put the path to the saved report in the Program arguments: field. For 
example: 


\WINNT\Profiles\reports\DailyReport.xls 


As example is shown in Figure 4-18. 


NewObject:D ailpReport |. (OF x} 
“ => G > NewObject:DailyRepott Y ry 

Windows Application : 

[C:\Program Files\Microsoft Office\Office\excel.exe Browse... | 

Program arguments: 


[\WINNT\Profiles\reports\DailyReport xls 


Figure 4-13. Example Configured Report Aspect 
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The following optional Excel parameters may be added at the beginning of the 
Program arguments: field: 


e  /R-—opens the workbook in read-only mode. 
e /E-—don’t show Excel splash screen on startup 
For example: 


/R /E \WINNT\Profiles\reports\DailyReport.xls 


NOTE 


e To associate each instance of a report with a plant object you 
must create a separate aspect for each instance. 


e You can also create report aspects for files saved from ad- 
hoc queries; however, such files can only be used in read- 
only mode. The queries cannot be re-run. 
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The OPC server that History is connected to is specified in the text file 


Aavant Reports Add-Ins User’s Guide 


Section 


hscCONFIG_FILE. You can open this file with a text editor such as Notepad. 
Access to this file is via the SHS_CONFIG% environment variable which points to 
the directory where the file resides. To open the file, in Notepad or similar text 
editor, specify the file path in the Open dialog, Figure A-1. 


Ej Untitled - Notepad 


File Edit Search Help 


lookin fot) »| @) eee 


abb Documentum 
Acrobat3 ExecSoft 
Adobeapp Feicwin 


citect FilesforPankaj 
# Contig. Msi HyperCam 
CurrentS tuff HySnap 


File name: 


Files of type: 


[%HS5_CONFIG2\hscCONFIG_FILE 


Internet Explorer 
ipStuff 
miscellaneous 
MSOffice 
Multimedia Files 
@ notes 


aL 


Figure A-1. Specifying the Path to hscCONFIG_FILE 
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The contents of the file are shown in Figure A-2. 


ff hscCONFIG_FILE - Notepad 


File Edit Search Help 
History Collection Configuration File hscCONFIG_FILE 
it 


# lines beginning with a #'or blank lines are ignored 


# OPC Server ProgID 


# This name defines the ope server that collection should connect ta 

it If no server is desired, the choice "NO_OPC_SERVER" should be selected 
#OPC_SERVER_ PROG ID NO_OPC_SERVER /* don't connect to any ope server 
#OPC_SERVER_PROG_ID RSIOPCEmulator.] /* no time stamp with data */ 

#OPC_ SERVER PROG ID OPC Fix. /* Time Stamp doesn't change */ 
#OPC_SERVER_PROG_ID  FactorySoft. nproc /* Time Stamped, inproc */ 
#OPC_SERVER_PROG_ID ABB.AF100.1 f* AF-100 OPC Server for AC7O */ 
#OPC_SERVER_PROG_ID ABB .AfwOPCHandler.1 J* Test Server, 1 second data */ 
#OPC_SERVER PROG_ID  Citect.OPC /* Automation Connections OPC § 
OPC_SERVER_PROG_ID Advant. Adv DsOPC DataServer. 1 /* Actual Sinus Data Server */ 

# OPC steady data timeout 

it This value is used to timestamp data from OPC that doesn't change. Idatais 

it not changing, OPC will NOT send updates. This time out value will be used to 

it supply anew time stamp to the data that hasn't changed. 

it 

OPC_UPDATE_DATA_TIME 30 /* If value hasn't changed for 30 se 
it /* Then add anew entry with same 


Figure A-2. hscCONFIG_FILE 
The server that History is connected to is the one that is not commented out (does 


not have # character at the beginning of the line). As shown in Figure A-2, the 
default server is Advant .AdvDsOPCDataServer.1. 
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